Skip to main content
PATCH
/
v1
/
me
/
webhooks
/
{id}
`PATCH /v1/me/webhooks/{id}` — partial update of a subscription keeping its `id` (and so its `webhook_deliveries` history) intact.
curl --request PATCH \
  --url https://api.pegana.xyz/v1/me/webhooks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "is_active": true,
  "threshold_bps": 123,
  "url": "<string>"
}
'
{
  "asset": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_active": true,
  "threshold_bps": 123,
  "url": "<string>"
}

Authorizations

​
Authorization
string
header
required

Session JWT issued by POST /v1/auth/telegram (Telegram Login Widget) or POST /v1/auth/magic/consume. Send as Authorization: Bearer <jwt>.

Path Parameters

​
id
string<uuid>
required

Webhook subscription id

Body

application/json
​
is_active
boolean | null

Toggle active state without deleting the row. Useful for pause-then-resume during receiver maintenance.

​
threshold_bps
integer<int32> | null

Replace the alert threshold (1..10000 bps). Omit to leave unchanged.

​
url
string | null

Replace the destination URL. SSRF + length guards re-applied; omit to leave unchanged.

Response

Updated webhook

​
asset
string
required
​
id
string<uuid>
required
​
is_active
boolean
required
​
threshold_bps
integer<int32>
required
​
url
string
required